Previous Book Contents Book Index Next

Inside Macintosh: QuickTime /
Chapter 2 - Movie Toolbox / Movie Toolbox Reference
Functions for Getting and Playing Movies / Saving Movies


PutMovieIntoDataFork

The PutMovieIntoDataFork function allows you to store a movie in the data fork of a given file.

pascal OSErr PutMovieIntoDataFork (Movie theMovie, short fRefNum,
                                  long offset, long maxSize);
theMovie
Identifies the movie to be stored in the data fork of an atom. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).
fRefNum
Contains a file reference number for the data fork of the given file. You pass in an open write path in the fRefNum parameter.
offset
Indicates where the movie should be written.
maxSize
Indicates the largest number of bytes that may be written.
DESCRIPTION
If necessary, the file will be extended. If there is insufficient space to write the movie, either due to a lack of disk space or because of the limit specified in the maxSize parameter, this function returns a dskFullErr error code. If there is no limit on how much space the movie may take up in the file, pass 0 in the maxSize parameter.

ERROR CODES
invalidMovie-2010This movie is corrupted or invalid
Memory Manager errors
File Manager errors


Previous Book Contents Book Index Next

© Apple Computer, Inc.
6 JUL 1996